步骤 12:打包 Debug 和 Release¶
注意: 此示例适用于单配置生成器,不适用于多配置生成器(例如 Visual Studio)。
默认情况下,CMake 的模型是一个构建目录仅包含单个配置,无论是 Debug、Release、MinSizeRel 还是 RelWithDebInfo。 然而,可以设置 CPack 来捆绑多个构建目录,并构建一个包含同一项目的多个配置的软件包。
首先,我们希望确保 debug 和 release 构建为将要安装的库使用不同的名称。 让我们使用 d
作为 debug 库的后缀。
在顶层 CMakeLists.txt
文件的开头附近设置 CMAKE_DEBUG_POSTFIX
set(CMAKE_DEBUG_POSTFIX d)
add_library(tutorial_compiler_flags INTERFACE)
以及教程可执行文件上的 DEBUG_POSTFIX
属性
add_executable(Tutorial tutorial.cxx)
set_target_properties(Tutorial PROPERTIES DEBUG_POSTFIX ${CMAKE_DEBUG_POSTFIX})
target_link_libraries(Tutorial PUBLIC MathFunctions tutorial_compiler_flags)
我们还要为 MathFunctions
库添加版本编号。 在 MathFunctions/CMakeLists.txt
中,设置 VERSION
和 SOVERSION
属性
set_property(TARGET MathFunctions PROPERTY VERSION "1.0.0")
set_property(TARGET MathFunctions PROPERTY SOVERSION "1")
从 Step12
目录中,创建 debug
和 release
子目录。 布局将如下所示
- Step12
- debug
- release
现在我们需要设置 debug 和 release 构建。 我们可以使用 CMAKE_BUILD_TYPE
来设置配置类型
cd debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .
cd ../release
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .
现在 debug 和 release 构建都已完成,我们可以使用自定义配置文件将两个构建打包到单个 release 中。 在 Step12
目录中,创建一个名为 MultiCPackConfig.cmake
的文件。 在此文件中,首先包含由 cmake
可执行文件创建的默认配置文件。
接下来,使用 CPACK_INSTALL_CMAKE_PROJECTS
变量来指定要安装的项目。 在本例中,我们要安装 debug 和 release。
include("release/CPackConfig.cmake")
set(CPACK_INSTALL_CMAKE_PROJECTS
"debug;Tutorial;ALL;/"
"release;Tutorial;ALL;/"
)
从 Step12
目录中,运行 cpack
,使用 config
选项指定我们的自定义配置文件
cpack --config MultiCPackConfig.cmake